home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 006a / pcburm15.zip / PCBURM.DOC < prev    next >
Text File  |  1993-04-01  |  15KB  |  374 lines
  1.                                   PCBURM
  2.                                 -----------
  3.  
  4.                          PCBoard User Ratio Monitor
  5.  
  6.                    A PCBoard File/Byte Download Monitor
  7.  
  8.                                Version 1.5
  9.  
  10.                             For PCBoard v14.5a
  11.  
  12.  
  13.                                 - - - - -
  14.  
  15.  
  16.                        Copyright 1993 - Robert Neal
  17.                                 317 Hickory
  18.                            Romeoville, IL  60441
  19.  
  20.                                Support BBS:
  21.                        Corporate Headquarters BBS
  22.                  Node #1: (815) 886-3233  14400 v.32bis
  23.                  Node #2: (815) 886-9381  14400 v.32bis
  24.  
  25.  
  26.  
  27.  
  28. Changes to this documentation file from the previous version are
  29. indicated by "|" in the left hand margin. This should make finding
  30. changes to the documentation much easier and faster for those upgrading
  31. from previous versions.
  32.  
  33.  
  34.  
  35.                            PROGRAM INFORMATION
  36.                            ===================
  37.  
  38. PCBoard User Ratio Monitor (PCBURM) is a utility door written for PCBoard
  39. v14.5a. PCBURM will enforce your desired ratios with each call the user makes
  40. to your board. PCBURM was written because PCBoard lacks a ratio enforcement
  41. method that is easy to use and understand, and one that can be run "real
  42. time". In looking around for similar products, everyone I've seen seem to be
  43. overkill, didn't effectively handle particular user requirements or just plain
  44. didn't seem to work.
  45.  
  46. In creating PCBURM, it was designed to be just one thing, a file/byte
  47. monitoring and enforcement tool for PCBoard. PCBURM will check for either a
  48. file ratio, byte ratio or both, sysop defined. There is no "banking" features,
  49. message ratio monitoring or things of that sort. This was decided so that
  50. PCBURM would be SIMPLE AND EASY for any sysop to get up and running in a
  51. matter of minutes.
  52.  
  53. Features of PCBURM:
  54.  
  55.         o Support for baud rates up to 115,200 bps
  56.         o Support for non-standard COM IRQ's
  57.         o Complete monitoring of COM ports for carrier loss
  58.         o Option to display comment to user
  59.         o Option to exclude security levels
  60.         o Option to print log information to CALLERx file
  61.         o Full Multi-Node support
  62.         o Sysop function keys are supported
  63.         o Most of all - SIMPLE to use
  64.         o Supports Fossil driver
  65.  
  66.  
  67.  
  68.                       PROGRAM INSTALLATION/OPERATION
  69.                       ==============================
  70.  
  71.  
  72. Step #1: - Create configuration file
  73. ========
  74.  
  75. Edit PCBURM configuration file, PCBURM.CFG using the program URMCFG.EXE
  76. included with PCBURM. You may also manually edit PCBURM.CFG using your
  77. favorite text editor.
  78.  
  79. The items in the configuration file are as follows, do not include the line
  80. number references. Refer to detailed explanation below for each line:
  81.  
  82.         PCBURM.CFG
  83.         ------------------------------------------
  84. Line 1: C:\PCB\USERS.SYS
  85. Line 2: Corp Headquarters
  86. Line 3: Bob
  87. Line 4: Neal
  88. Line 5: 0
  89. Line 6: PCBURM.LOG
  90. Line 7: 1
  91. Line 8: 50000
  92. Line 9: /10/25/50          (or the word NONE)
  93. Line10: STRICT             (or the word NOSTRICT)
  94. Line11: NO                (or the word YES)
  95. |Line12: VIOLATE.FIL      (or enter NONE)
  96.  
  97. Line 1: Enter full path/filename of your USERS.SYS file. PCBURM supports the
  98.         PCB environment variables, %PCBDRIVE% and %PCBDIR%. Those running a
  99.         multi-node system may wish to replace this line with the following:
  100.  
  101.                 %PCBDRIVE%%PCBDIR%\USERS.SYS
  102.  
  103.         PCBURM will read the current PCBoard drive and directory from these
  104.         variables.
  105.  
  106. Line 2: BBS Name
  107.  
  108. Line 3: Sysop's first name
  109.  
  110. Line 4: Sysop's last name
  111.  
  112. Line 5: Registration number, leave as 0 if not registered. You will be
  113.         be provided with a registration number to enter here when you
  114.         send you payment.
  115.  
  116. Line 6: If you place the word CALLER on this line, PCBURM will write it's log
  117.         information PCBoard's CALLERx file. I find this handy as I can
  118.         see each users status each time I scan my CALLERx file.
  119.  
  120.         You can also have PCBURM maintain it's own log file by placing the
  121.         full path/filename to be written to on this line. The log file created
  122.         will include the name of the user, node used, security level assigned
  123.         to the user as well as the date and a brief text line explaining what
  124.         ratio enforcements were placed on the user. If a user exceeded his
  125.         requirements, the log file will include the current ratios of the user
  126.         at the time the program monitored his activity.
  127.  
  128. Line 7: Free FILE credits to be given. You may use this line to give "free"
  129.         credits to new users. If you would like to grant some "free" credits
  130.         to a user, place the value here. In the above example, a new user
  131.         would be given credit for one upload. If a user was given a 5:1 file
  132.         ratio requirement, he could then download 5 files before needing to
  133.         upload anything. After downloading 5 files PCBURM would restrict
  134.         download ability until a file was uploaded.
  135.  
  136. Line 8: Free BYTE credits to be given. Same explanation for the file credit.
  137.         Using the above example, a new user could download 250,000 bytes if a
  138.         5:1 ratio was in place before he would need to upload anything. This
  139.         option allows new users access to your file area without requiring an
  140.         initial upload.
  141.  
  142.         Please note that the values used on line 7 and 8 are used internally
  143.         to the program. It will not actually add this information to the users
  144.         file, therefore keeping your user file statistics accurate (unlike
  145.         some other similar type of programs).
  146.  
  147. Line 9: You can optionally exclude specific security levels from ratio check
  148.         by placing the levels desired on this line. Seperate each level with
  149.         the "/" character, see example above. Place the word NONE on this line
  150.         if you do not wish to exclude any security levels from ratio check.
  151.  
  152. Line10: You can select if you want PCBURM to enforce a STRICT byte ratio
  153.         requirement or not. Placing the word STRICT on this line would
  154.         cause PCBURM to calculate the remaining number of bytes the user
  155.         could download. PCBURM will use this calculated figure if it is
  156.         less than the number of bytes granted a user in the PWRD file.
  157.         Put the word NOSTRICT on this line if you do not want this
  158.         feature, instead PCBURM will grant a daily download bytes equal
  159.         to what you have indicated in the PWRD file.
  160.  
  161. Line11: PCBURM can be set for discrete statistics display. Placing YES
  162.         on this line will display the full user statistics only if the
  163.         user is outside of the ratio limits you have prescribed. If the
  164.         user is within ratio limits, a single line display is shown.
  165.         Placing NO on this line will inform PCBURM to display the file
  166.         statistics display at each call.
  167.  
  168. |Line12: PCBURM can display a file to a user who violates your ratio
  169. |requirements. Enter the name of the file here or enter NONE if you do
  170. |not want to display a file.
  171.  
  172.  
  173.  
  174.  
  175. Step #2: - Create file ratio requirements file
  176. ========
  177.  
  178. Edit the requirement file, PCBURM.REQ. Use your favorite text editor to
  179. edit this file: The format is as follows:
  180.  
  181. SECURITY LEVEL, FILE RATIO, BYTE RATIO, USER COMMENT
  182.  
  183. For example:
  184.  
  185. 30,5,10,Regular User
  186. 40,10,20,Supporting User - Thanks for your payment
  187. 200,0,0,Sysop
  188. 999,1,1,Unknown Access Level - Please inform sysop
  189.  
  190. In the above example, the first line is for a security level 30 user. He has a
  191. 5:1 file ratio requirement, a 10:1 byte ratio requirement. The USER COMMENT
  192. field ("Regular User") will be displayed as part of the user statistics
  193. displayed by the program. You can use this field to put any information you
  194. desire, maybe enter information about subscription that your board may offer.
  195.  
  196. In the second example, this is for a security level 40 user. He has a 10:1
  197. file ratio requirement and a 20:1 byte ratio requirement.
  198.  
  199. In the third example, this is a security level 200 user. The file and byte
  200. ratios have been set to "0", this informs PCBURM that this user is exempt for
  201. maintaining any ratio requirements (might be used for subscribing user,
  202. co-sysops and sysops). You may set the byte and/or file ratio to zero if you
  203. do not with to enforce a ratio requirement.
  204.  
  205. The last example is recommended as the last line for every PCBURM.REQ file.
  206. This is used as the DEFAULT security ratio. If a security level is not found
  207. in the line preceeding this last line, these ratios will be assigned to the
  208. user. Using the above example, if the user had a security level of 60, PCBURM
  209. would use the file requirements as shown on this line as a level 60 was not
  210. previously assigned a ratio requirement.
  211.  
  212.  
  213.  
  214. Step #3 - Setup PCBURM as a door
  215. =======
  216.  
  217. Setup PCBURM as a PCBoard Door.  Run PCBSetup, edit the door security file and
  218. add the following line:
  219.  
  220.                                   USER DOOR
  221.  Filename    Password   Sec Login SYS  SYS  Shell Path to DOOR Files
  222. ══════════ ════════════ ═══ ═════ ════ ════ ═════ ═══════════════════     
  223. PCBURM                   0    Y    Y    N     Y
  224.  
  225. The "Login" and "Shell" are both optional. If you have enough memory, it is
  226. recommended that you use the "shell" option of PCBoard. The USERS.SYS field
  227. must be set to Y or PCBURM will not work!
  228.  
  229.  
  230. Step #4 - Create script file
  231. =======
  232.  
  233. Edit the PCBURM door script, again using your favorite text editor. Below is
  234. an example of a suggested script (example presumes PCBURM is located on drive
  235. "C" and in directory "PCBURM"):
  236.  
  237.      @ECHO OFF
  238.      C:
  239.      CD \PCBURM
  240.      PCBURM PCBURM.CFG
  241.      %PCBDRIVE%
  242.      CD %PCBDIR%
  243.      IF (%INPCB%)==(Y) EXIT
  244.      BOARD
  245.  
  246. The line "IF (%INPCB%)==(Y) EXIT" is used to exit from shelled doors. If you
  247. won't run PCBURM as a shelled door, it may be removed.
  248.  
  249. PCBURM supports COM1-4, using standard IRQ's. If you wish to use a
  250. non-standard IRQ, add the IRQ number after the configuration file name. For
  251. example "PCBURM PCBURM.CFG /5" (tells PCBURM to use IRQ 5 instead of standard
  252. IRQ value). No parameter is required if using standard IRQ values.
  253.  
  254. |Some users may have had conflicts when using non-standard IRQ's on
  255. |Novell/Netware systems. Novell seems to use the "/" character for
  256. |parameter passing. You may not optionally use the "*" character instead
  257. |of the "/".
  258.  
  259.  
  260. That's all there is to do. PCBURM will adjust the daily download bytes allowed
  261. as indicated in the PWRD file to monitor and enforce the file/byte ratio's. If
  262. you have used another file ratio enforcement program, check to see that you
  263. have re-entered this information in the PWRD file (some ratio enforcers have
  264. required you to zero out this information. Not PCBURM, PCBURM reads this
  265. information.
  266.  
  267. When PCBURM is run, it will display the users file/byte statistics. It will
  268. also display if the user is within your established ratio requirements, or if
  269. not, will inform him accordingly. In addition, PCBURM will maintain a log file
  270. (PCBURM.LOG) which will indicate what actions were taken by the program, or if
  271. the user was within ratio requirements. You may wish to delete this file
  272. regularly as necessary.
  273.  
  274.  
  275. FOSSIL DRIVER
  276. =============
  277.  
  278. PCBURM now includes support for FOSSIL drivers. This means that the
  279. program will now work with Digiboard (for PCBoard/M versions) and other
  280. multi-port boards. To activate the Fossil driver support just include
  281. /FD on the command line in your door batch file.
  282.         For example: PCBURM PCBURM.CFG /FD
  283.  
  284. If no Fossil driver is available, PCBURM will display a message
  285. indicating such and exit cleanly.
  286.  
  287.  
  288.  
  289.  
  290.  
  291.                               REGISTRATION
  292.                               ============
  293.  
  294. PCBURM is released as user support software (aka SHAREWARE). I don't expect
  295. you to register the program if you don't like it or if it doesn't meet your
  296. needs (just stop using it). But if you continue to use PCBURM after a
  297. reasonable evaluation period of up to 30 days, you are required to make
  298. payment for the program or stop using it.
  299.  
  300. PCBURM is NOT crippled in any way other than for a momentary reminder at the
  301. termination of the program that the program is not registered. Once you
  302. register the program, you will be provided with a registration number which
  303. will remove this reminder notice.
  304.  
  305. Registration is only $15 and will include unlimited free upgrades and support
  306. via my BBS.
  307.  
  308. Please use the form REGISTER.FRM included with the program to register PCBURM.
  309. If this file is missing, send a check for $15 (US funds) to:
  310.  
  311.         Robert Neal
  312.         317 Hickory
  313.         Romeoville, IL  60441
  314.  
  315. You may also register online with Visa/MC/AMEX and Discover by calling
  316. the support BBS (815) 886-3233 or (815) 886-9381. At the main menu type
  317. CHARGE, then follow prompts from there.
  318.  
  319. Please include your BBS name as this information will be used to create your
  320. unique registration key file. You may receive your registration file via my
  321. support BBS (but please be sure you have an account established on my BBS so
  322. that I can leave this information in a private message to you) or via the US
  323. Mail. Please indicate your preference.
  324.  
  325. Keep your eye open for other utility programs from me written for PCBoard.
  326. Several programs are now in the works and should be released soon. Also, look
  327. for my door programs, Card Sharks and Links Golf (available on my BBS as
  328. well), I think your users will enjoy playing them.
  329.  
  330.  
  331.                               TROUBLESHOOTING
  332.                            =====================
  333.  
  334. If you are running this on a 486 system with co-processor, you may need
  335. to put 'SET NO87=ON' in your AUTOEXEC.BAT file or you may place this in
  336. the PCBURM batch file just before the line PCBURM PCBURM.CFG, for
  337. example:
  338.  
  339.      @ECHO OFF
  340.      C:
  341.      CD \PCBURM
  342.      SET NO87=ON
  343.      PCBURM PCBURM.CFG
  344.      %PCBDRIVE%
  345.      CD %PCBDIR%
  346.      IF (%INPCB%)==(Y) EXIT
  347.      BOARD
  348.  
  349.  
  350. If you are running on a 486 system with co-processor under DesqView, you
  351. may alternately set Math Coprocessor in each window to YES.
  352.  
  353.  
  354.  
  355.  
  356.                                   SUPPORT
  357.                             ===================
  358.  
  359. If you have any questions, comments, problems, suggestions for enhancements,
  360. etc., I may be reached at my support BBS or by mail. In addition, you may send
  361. a message to me on the RIME conferences to my BBS "CHQBBS", I regularly
  362. monitor the messages in the Sysop, BBS and PCBoard Support conferences. I can
  363. also be reached via Prodigy, PNSP01A.
  364.  
  365.  
  366.  
  367.                              LEGAL INFORMATION
  368.                       ===============================
  369.  
  370. This program is provided on an "AS IS" basis.  No warranty of any kind is
  371. expressed or implied.  YOU USE THIS PROGRAM AT YOUR OWN RISK.  I take no
  372. responsibility for any damage caused directly or indirectly from the use or
  373. the inability to use this program.
  374.